home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / xmcd-1.4 / xmcd-1.4.README < prev    next >
Encoding:
Text File  |  1995-05-10  |  12.4 KB  |  334 lines
  1.             --------------------
  2.             X M C D  version 1.4
  3.                 patchlevel 2
  4.             --------------------
  5.                  by Ti Kan
  6.  
  7.  
  8. This is xmcd version 1.4, a package including xmcd, an X11/Motif-based
  9. CD player utility and cda, a command-line driven, non-graphical CD
  10. audio player.  This software represents many months of development and
  11. refinements, as well as a beta test program involving many dedicated
  12. individuals around the world.
  13.  
  14.  
  15. The source code of this version of xmcd and cda supports the following
  16. operating systems environments:
  17.  
  18.  
  19.     1.  Apple A/UX (on Apple Macintosh 680x0)
  20.         - A/UX version 3.0 or later
  21.           (with devscsi module installed)
  22.  
  23.     2.  Data General DG/UX (on DG AViiON m88k)
  24.         - DG/UX version 5.4R3.00 or later
  25.  
  26.     3.  DEC OSF/1 (on DEC Alpha AXP)
  27.         - DEC OSF/1 version 1.3 or later
  28.  
  29.     4.  DEC Ultrix (on DECstation)
  30.         - DEC Ultrix version 4.3 or later
  31.           (with SCSI CAM installed)
  32.  
  33.     5.  FreeBSD (on Intel x86 PC-compatible)
  34.         - FreeBSD 2.1 or later with XFree86 (X11R5 or X11R6) +
  35.           Motif 1.2
  36.  
  37.     6.  Hewlett Packard HP-UX (on HP Series 700 PA-RISC)
  38.         - HP-UX Release 9.x or later
  39.  
  40.     7.  IBM AIX (on IBM RS/6000 Power/PowerPC and compatibles from Bull)
  41.         - AIX version 3.2.x
  42.         - AIX version 4.x
  43.  
  44.     8.  Linux (on Intel x86 PC-compatible)
  45.         - Linux 0.99 or later with XFree86 (X11R5 or X11R6) + Motif 1.2
  46.  
  47.     9.  SCO UNIX System V Release 3.2 (on Intel x86 PC-compatible)
  48.         - SCO Open Desktop Version 2.x (X11R4 or X11R5 server)
  49.         - SCO Open Desktop Version 3.x
  50.         - SCO UNIX 3.2v4.x with XFree86 (X11R5 or X11R6) + Motif 1.2
  51.  
  52.     10. Silicon Graphics IRIX (on SGI)
  53.         - IRIX version 4.x
  54.         - IRIX version 5.x
  55.  
  56.     11. Stratus FTX System V Release 4 (on Stratus PA-RISC)
  57.         - FTX version 3.x
  58.  
  59.     12. SunOS (on Sun Sparc and compatibles)
  60.         - SunOS 4.1.x / Solaris 1.x
  61.  
  62.     13. SunOS System V Release 4 (on Sun Sparc and compatibles)
  63.         - SunOS 5.x / Solaris 2.x
  64.  
  65.     14. SunOS System V Release 4 (on Intel x86 PC-compatible)
  66.         - SunOS 5.x / Solaris 2.x
  67.  
  68.     15. UNIX System V Release 4.0 (on Intel x86 PC-compatible)
  69.         (Note: 4.0.3 or later recommended)
  70.         - AT&T
  71.         - Consensys
  72.         - Dell
  73.         - ESIX
  74.         - ISC
  75.         - Microport
  76.         - Micro Station Technology
  77.         - UHC
  78.         - USL
  79.  
  80.     16. UNIX System V Release 4.0 (on Motorola 88k)
  81.         - Motorola
  82.  
  83.     17. UNIX System V Release 4.2 (on Intel x86 PC-compatible)
  84.         - Consensys
  85.         - Information Foundation
  86.         - Novell/Univel UnixWare 1.x
  87.         - Onsite
  88.         - USL
  89.  
  90.     18. UNIX System V Release 4.2MP (on Intel x86 PC-compatible)
  91.         - Novell/USL UnixWare 2.x
  92.  
  93.  
  94. This release of xmcd features the following:
  95.  
  96.     - Standard functions: Stop, Play, Pause, Next/Previous Track,
  97.       Next/Previous Index, Fast forward/rewind with audio sample,
  98.       Eject and On/off.
  99.     - Direct track access keypad and track-warp slider controls.
  100.     - Volume control with selectable taper characteristics.
  101.     - Balance control.
  102.     - Channel routing control: Select between normal stereo,
  103.       reversed stereo, mono-L, mono-R, or mono-L+R.
  104.     - Track/Index/Time display: Selectable to display elapsed time,
  105.       remaining track time, or remaining disc time.
  106.     - Status display: for current play status, A->B mode, program
  107.       mode, CD database.
  108.     - Shuffle (random) play function.
  109.     - Repeat function with iteration counter.
  110.     - Sample function: Play a few seconds of each track.
  111.     - A->B function: Repeat from selectable point A and B.
  112.     - Eject inhibit function: To prevent someone from ejecting the
  113.       disc by pressing the button on the drive.
  114.     - Automation options on CD load, eject, play completion and
  115.       program exit.
  116.     - Track Program function: Play tracks in custom order.
  117.     - CD database function: Allows you to store CD title/track titles
  118.       in database, and associate each disc with a play program.
  119.       Displays the current playing disc title/track information.
  120.       In addition, you can enter and display arbitrary text associated
  121.       with the disc or each track, such as band information, lyrics,
  122.       etc.
  123.     - CD database entry send: Contribute CD database entries to
  124.       a central archive via Internet electronic mail.
  125.     - Main window button face labels can be configured to display
  126.       pictorial symbols, or text with hotkey mnemonics.
  127.     - The complete application can be operated via the keyboard with
  128.       full support for keyboard traversal and hotkeys.
  129.     - All labels and messages can be customized to non-English
  130.       languages via X resources in the .Xdefaults file.
  131.     - All colors and many other functionality are user-customizable
  132.       using X resource settings.
  133.     - On-line help information.
  134.     - Attractive, intuitive-to-use Motif user interface.
  135.     - Device-specific configuration files to make xmcd adaptable
  136.       to various brands of CD-ROM drives.
  137.  
  138. Xmcd uses the Motif toolkit to achieve a pleasing appearance, such that
  139. it actually looks and feels like a real CD player for all basic
  140. functions, yet takes advantage of the GUI and window system to make
  141. programming and CD database functions easy.
  142.  
  143. Currently, the cda utility offers almost the same functionality as
  144. xmcd except the FF, REW, Sample and A->B features are not available.
  145. Also, the CD database is read-only via cda (no updates).  In addition,
  146. a visual mode is available that turns cda into a screen-oriented
  147. (curses-based) CD player.
  148.  
  149.  
  150. This release of xmcd and cda should work with the following CD-ROM
  151. drives:
  152.  
  153.     Apple
  154.         CD SC+, CD-150, CD-300, CD-300i
  155.     Chinon
  156.         CDS-431, CDX-431, CDS-435, CDX-435, CDS-525, CDX-525,
  157.         CDS-535, CDX-535
  158.     Compaq
  159.         CDU-561, CR-503BCQ
  160.     Creative Labs
  161.         CD-ROM (#)
  162.     DEC
  163.         RRD42, RRD43, RRD44
  164.     Hitachi
  165.         CDR-1650S, CDR-1750S, CDR-1950S, CDR-3650, CDR-3750,
  166.         CDR-6750
  167.     IBM
  168.         7210-001
  169.     Mitsumi
  170.         FX001S (#). FX001D (#), FX001DE (#), LU005S (#)
  171.     NEC
  172.         CDR-72, CDR-74, CDR-77, CDR-80, CDR-82, CDR-84,
  173.         CDR-38, CDR-74-1, CDR-84-1,
  174.         CDR-210P, CDR-260 (#), CDR-260R (#),
  175.         CDR-400 (Multispin 3X), CDR-500 (Multispin 3X),
  176.         CDR-510 (Multispin 3X), CDR-600 (Multispin 3X),
  177.         CDR-501 (Multispin 4x), CDR-601 (Multispin 4X)
  178.         CDR-900 (4XPro)
  179.     Kotobuki/Matsushita/Panasonic
  180.         CR-521 (#), CR-562 (#), CR-563 (#)
  181.     Pioneer
  182.         DRM-600, DRM-600A, DRM-610, DRM-602X, DRM-604X,
  183.         DRM-1804X
  184.     Plextor/Texel
  185.         DM-3024, DM-5024, DM-3028, DM-5028, PX-43CH (4Plex),
  186.         PX-45CH (4Plex), PX-43CS (4Plex), PX-45CS (4Plex)
  187.     Procom
  188.         CDT4-3X, CDT4-DS, CDT4-MX, CDT7-3X, CDT7-DS,
  189.         DSP-DR0020, ICD-MX, MCD-DS, MCDN-3X, SICD-DS,
  190.         SICDN-3X, SXCD-DS, SXCDN-3X
  191.     Sony
  192.         CDU-31A (#), CDU-33A (#), CDU-55E (#), CDU-55S,
  193.         CDU-541, CDU-561, CDU-6111, CDU-6211, CDU-7211,
  194.         CDU-7811, CDU-8002, CDU-8003, CDU-8003A, CDU-8012
  195.     Sun
  196.         CD-ROM (Sony OEM), CD-ROM (Toshiba OEM)
  197.     Toshiba
  198.         XM-3101, XM-3201, XM-3301, XM-3401, XM-3501,
  199.         XM-4101, XM-8100
  200.  
  201.     Other SCSI-2 compliant CD-ROM drives
  202.     Other non-SCSI CD-ROM drives (#) (driver support required)
  203.  
  204. Units denoted with a hash symbol (#) are currently supported only on
  205. the Linux platform.  These drives are typically used with a
  206. proprietary interface card or a sound card.
  207.  
  208.  
  209. The source code release of xmcd/cda version 1.4 is available via
  210. Internet anonymous FTP.  Location:
  211.  
  212.     (Instructions)
  213.     ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.README
  214.     (gzip'd tar archive)
  215.     ftp.x.org:/contrib/applications/xmcd/xmcd-1.4.tar.gz
  216.  
  217. An xmcd CD database is also available via anonymous FTP:
  218.  
  219.     (Instructions)
  220.     ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.README
  221.     (gzip'd tar archive)
  222.     ftp.x.org:/contrib/applications/xmcd/xmcd-cddb.tar.gz
  223.  
  224. Both packages require the "gunzip" (GNU unzip) utility to uncompress.
  225. The source code to gzip/gunzip can be found on various FTP sites
  226. (such as prep.ai.mit.edu:/pub/gnu).
  227.  
  228. This CD database is periodically updated with more entries, and you are
  229. encouraged to contribute to this database by using the "Send" feature
  230. in xmcd.
  231.  
  232. Binary releases of xmcd and cda for certain OS environments are also
  233. available from the author.   Please write to "ti@amb.org" for more
  234. information.
  235.  
  236.  
  237. Changes since v1.3:
  238. -------------------
  239.  
  240. CD-ROM drive support changes:
  241.     - Added support for the Chinon CDx-525, DEC RRD44, NEC CDR-210P,
  242.       Plextor PX-43CS/PX-45CS, Sony CDU-55S and Toshiba XM-3501
  243.       SCSI CD-ROM drives.
  244.     - On the Linux platforms only, added support for the Mitsumi
  245.       FX001, LU005S, NEC CDR-260, CDR-260R, Panasonic/Matsushita/Kotobuki
  246.       CR-521, CR-562, CR-563, and Sony CDU-31A, CDU-33A and CDU-55E
  247.       CD-ROM drives.  These are non-SCSI drives using a proprietary
  248.       interface card, sound card or an IDE/EIDE/ATAPI interface.
  249.       Xmcd/cda must be configured to run using the SunOS/Linux ioctl
  250.       method to use these (rather than SCSI pass-through).  Also,
  251.       the appropriate driver support must be configured in the kernel.
  252.     - On SCSI-2 drives, the IMMED bit in the Start Stop Unit
  253.       SCSI command CDB is now set.  This causes the CD ejects
  254.       command to complete immediately, avoiding command time-out
  255.       situations on some platforms.
  256.     - When ejectOnExit was set, the CD wasn't being ejected when the
  257.       program quits (on certain SCSI-1 CD-ROM drives only).  This is
  258.       now fixed.
  259.     - The version number of the LIBDIR/xmcd/config/.cfgtbl/* files
  260.       have been bumped to 2.  A new field is added to these files
  261.       to configure the new noTURWhenPlaying parameter in device.cfg.
  262.  
  263. OS Support changes:
  264.     - Add support for the FreeBSD (version 2.1 or later) platform.
  265.       See the README file for special notes about the kernel and
  266.       SCSI driver configuration.
  267.     - The configure.sh script was not properly setting the MAILCMD
  268.       variable on some OS platforms.  Fixed.
  269.     - Added a SunOS/Linux ioctl method module to libdi.  This is
  270.       primarily used to support non-SCSI CD-ROM drives using a
  271.       proprietary interface card under Linux.  Although this method
  272.       can be used with SCSI CD-ROM drives under Linux, SunOS 4.1.x,
  273.       and Solaris 2.x platforms, it is recommended that the SCSI
  274.       pass-through method be used instead.
  275.     - Fixed a problem with the volume slider not being properly
  276.       initialized on the DEC OSF/1 and Motorola SVR4/m88k platforms.
  277.     - The configure.sh script no longer rejects a device node path
  278.       that doesn't exist on the Solaris 2.x platform with the
  279.       Solaris Volume Manager.
  280.  
  281. Misc changes:
  282.     - Enhanced the libdi design such that multiple CD-ROM controlling
  283.       methods can be implemented and coexist.  The original support for
  284.       SCSI pass-through is now an instance of a method.  This change
  285.       involves adding another jump table for all libdi functions
  286.       to branch control to the appropriate method.  The device.cfg
  287.       file now has a new deviceInterfaceMethod parameter that
  288.       configures the actual method to use.  See the PORTING file
  289.       for details.
  290.     - The cda utility now supports a "visual" mode that turns cda
  291.       into a screen-oriented (curses-based) CD player.
  292.     - Implemented work-around to avoid hitting a bug in some versions
  293.       of Motif-1.2.  The symptom was a xmcd crash when the
  294.       CDDB/Program subwindow is closed.
  295.     - The xmcd CDDB/Program window Track List now highlights
  296.       the appropriate entry when a track title is being edited in
  297.       the Track Title Editor box, even if a track is not explicitly
  298.       selected.  Also, the Track List now automatically scrolls down
  299.       as tracks titles are entered.
  300.     - Xmcd now displays an error message if a CDDB Save operation
  301.       fails due to a full filesystem.
  302.     - The dbdir parameter in common.cfg and the XMCD_DBPATH environment
  303.       variables now support tilde-expansion (e.g., ~/somepath or
  304.       ~someuser/somepath is now handled correctly).
  305.     - Xmcd and cda now creates a directory /tmp/.cdaudio.  All
  306.       lock files, fifo nodes, and other temporary files are created
  307.       and deleted under that directory (instead of directly in /tmp).
  308.       This is because many platforms set the sticky bit in the
  309.       /tmp directory permissions, making it cumbersome for xmcd/cda to
  310.       maintain lock files (one user's xmcd process should be able to
  311.       delete another's lock file if the other process has exited).
  312.     - The misc.d/makesrc.sh and misc.d/makerel.sh scripts have been
  313.       further enhanced to print informative messages, and these now
  314.       work correctly on systems with a limited command line length.
  315.     - Removed the BUGS file and added the FAQ file.
  316.     - Added the "reggae" and "folk" categories to the standard
  317.       CD database.
  318.     - Other enhancements and cleanups.
  319.  
  320.  
  321. Xmcd v1.4 patchlevel 1:
  322. -----------------------
  323. OS Support changes:
  324.     - Corrected a minor problem with the FreeBSD platform support.
  325.  
  326.  
  327. Xmcd v1.4 patchlevel 2:
  328. -----------------------
  329. CD-ROM Support changes:
  330.     - Corrected a problem with the Sony CDU-55E ATAPI CD-ROM
  331.       drive support on the Linux platform.
  332.  
  333.  
  334.